home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 3 / Precision Software Applications Silver Collection Volume Three (PSM) (1993).iso / drivers / qdel030.exe / QDEL.DOC next >
Text File  |  1992-10-20  |  6KB  |  160 lines
  1.  
  2.  
  3.                 QDEL version 0.30 Instruction Manual
  4.                 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  5.                      (C) Konrad Budych 1991-92
  6.  
  7.  
  8.         What is QDEL ?
  9.         ~~~~~~~~~~~~~~
  10.         QDEL is the program which deletes all files and sub-directories
  11. starting from the specified directory (or directories).  It may skip specified
  12. sub-directories and/or leave files in specified sub-directories intact.  It
  13. may show you the number of directories deleted and amount of disk space freed.
  14.  
  15.         Starting from version 0.30 QDEL is almost as fast as 'DEL *.*' and
  16. much faster than ever before!  This can be noticed when QDELing diskettes ---
  17. in some tests QDEL v0.30 was 30 times faster then QDEL v0.22!  This is because
  18. QDEL now uses obsolete, but very fast Delete-via-FCB DOS function.
  19.  
  20.         Keep this program away from babies and children!
  21.         
  22.         And have fun using this program!
  23.  
  24.  
  25.         How to use it ?
  26.         ~~~~~~~~~~~~~~~
  27.         To install QDEL, copy QDEL.EXE to a directory listed in your PATH.
  28.  
  29.         Use QDEL as follows:
  30.  
  31.                 QDEL [switches] dir [dir...]
  32.  
  33.         'dir' is a directory name like 'A:\', '.', 'D:..', 'C:\OLD', etc.
  34.  
  35.         'switches' can be placed anywhere in command line, but they are
  36. effective from the place they occur.  They cannot be joined together.  They
  37. can be followed by '+' or '-', otherwise their state is toggled each time they
  38. are used.  See below for detailed description.
  39.  
  40.         QDEL never asks any questions by default.  This can be changed.
  41.  
  42.         QDEL cannot remove current or root directory.  This cannot be changed.
  43.  
  44.  
  45.         Switches description
  46.         ~~~~~~~~~~~~~~~~~~~~
  47.         *       '?' - help screen
  48.  
  49.         This displays help screen.  'QDEL A:\ /?' works as expected --- first
  50. clears A: then displays help screen.  But 'QDEL /? A:' works the same way ---
  51. help screen is always displayed after everything else is done.
  52.  
  53.         *       '-' - disable a '-' as switch prefix
  54.  
  55.         Use this if you want to delete a directory with the name beginning
  56. with a '-' (eg.  'QDEL -- -DIR-') or if you always use '/' to precede
  57. switches.
  58.  
  59.         *       'p' - prompt before processing each directory
  60.  
  61.         QDEL will ask two question before processing any directory
  62.  
  63.                 "Proceed to DIRECTORY (Yes/No/Fast/ESCape)?"      and
  64.                 "Delete files in DIRECTORY (Yes/No/ESCape)?"
  65.  
  66.         If you answer <F> for the first question, QDEL will automatically
  67. proceed to all DIRECTORY's sub-directories.  <ESC> quits.  Answers <Y> and <N>
  68. do expected things.
  69.  
  70.         *       'q' and 'Q' - quiet work
  71.  
  72.         If 'q' is on, QDEL will display only prompts, statistics, help screen,
  73. and errors.  If 'Q' is on, QDEL will display only prompts.  Prompts are
  74. displayed only if 'p' is on.
  75.  
  76.         *       's' - statistics and more...
  77.  
  78.         This is the only switch which is on by default.  It makes QDEL display
  79. a number of directories processed, amount of disk space freed, and scores.
  80. All directories are counted, even those which where processed with 's' off.
  81.  
  82.         You get 1 point for each 4 kB of disk space freed, 20 points for each
  83. directory removed.  Bonus: 5 point for each read-only file, 10 points extra
  84. for each directory, if you deleted more than 40 of them, and 1 point extra for
  85. each 2 kB of disk space freed, if more than 4 MB was freed.  This is very
  86. useful to estimate the results of QDEL's work.
  87.  
  88.         Unfortunately high scores are not stored.
  89.  
  90.         Help screen and statistics are not displyed together.
  91.  
  92.  
  93.         Examples
  94.         ~~~~~~~~
  95.                 QDEL -p+ C:\           you will be asked what to delete
  96.                 QDEL -Q A:\            clear diskette quietly
  97.                 QDEL -Q A:\ B:\        clear two diskettes quietly
  98.                 QDEL .                 delete current directory and deeper
  99.  
  100.  
  101.         Configuring QDEL
  102.         ~~~~~~~~~~~~~~~~
  103.         If you wish always start QDEL with certain switches, put them in QDEL
  104. environment variable using SET command.  These switches will be read before
  105. any command line parameters.  For example, you may want to add this to your
  106. AUTOEXEC.BAT.
  107.  
  108.                 SET QDEL=-p -s
  109.  
  110.         Switches must not be joined together, as usually.
  111.  
  112.  
  113.         Where to buy 
  114.         ~~~~~~~~~~~~ 
  115.         Nowhere.  QDEL is free.  You may give it away to friends and foes.
  116. But you are not permitted to sell or modify it.  If you distribute QDEL,
  117. please distribute original, unmodified archive file.
  118.  
  119.         If you think this program is great, please send something to the
  120. author (diskettes, money, postcards, your programs, etc.).  You can contact the
  121. author via e-mail (Internet address: kbudych@ii.uj.edu.pl) or via 'snail-mail'
  122. (address: Konrad Budych; os.Boh.Wrzesnia 24/67; 31-621 Krakow; Poland).
  123.  
  124.  
  125.         Disclaimer
  126.         ~~~~~~~~~~
  127.         QDEL is supplied as is.  The author disclaims all warranties,
  128. expressed or implied, including, without limitation, the warranties of
  129. merchantability and of fitness for any purpose.  The author assumes no
  130. liability for any damages, direct or consequential, which may result from the
  131. use of, or inability to use QDEL.
  132.  
  133.  
  134.         Revision history
  135.         ~~~~~~~~~~~~~~~~
  136. 0.30:   Fast '*.*' deleting.
  137.         New statistics and scores; bonuses added.
  138.         'N', 'Y', 'S' switches removed; 's' now on by default.
  139.         New command line scanning procedure.
  140.         Documentation and messages modified.
  141.         Version number increased by 0.08 because of many changes.
  142. 0.22:   '-' switch added.
  143.         New command line scanning procedure.
  144.         Some messages changed.
  145. 0.21:   's' and 'S' switch added.
  146.         Scores added.
  147.         Documentation rewritten.
  148. 0.20:   First version of Second Edition of QDEL.
  149.         Rewritten from Turbo Pascal to Turbo C++.
  150.         Oldest switches ('?', 'q', 'Q', 'p', 'Y', and 'N') added.
  151.         Multiple directories allowed.
  152.         256-characters-long paths supported (for Novell NetWare volumes).
  153.         Cosmetic changes.
  154.         Version number incresed by 0.12 because of many changes.
  155. 0.08:   Released within QKit 1.00.
  156.         Documented for the first time.
  157. 0.0x:   Minor changes, no severe bugs found.
  158. 0.01:   First release of QDEL: no switches, one directory allowed.
  159.  
  160.